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LDP BUILD/INIT Internal Description 


The program building and volume initialization functions of 
the LDP system are performed by the program BUILD, and its 
alias, INIT. 

1.0 Assembly Instructions 

The source for this program is named B01 (version 1), and is 
a DIAL-MS^source. It contains a LISTAPE CREF statement, where 
CREF=14, so that the output may be processed by CREF12. The 
source is assembled by the following sequence of DIAL-MS com¬ 
mands : 


ZE J 

+ AS B01,u} 

+ SB B01,u,P04 000J 


2.0 Binary File Structure 


Every binary file in the LDP system can be considered as having 
four parts: 


header 

primary binary 
secondary binaries 
scratch area 


The header, which is one block long, is the first block in the 
file and contains information for the loader, as follows: 


location (words) 


information 


0-353 

354-356 

357 

360-377 


unused 

starting information 
number of blocks in primary 
binary 

bit map indicating primary 


1 

LAP6-DIAL-MS is referred to as DIAL-MS in this manual. 
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The primary binary is the main code for the program and is 
loaded entirely by the loader, except for the field 0 loca¬ 
tions reserved for the Monitor. Binary code that is used 
by the program, but is not loaded by the loader, is referred 
to as the secondary binaries. Overlays and help frames are 
typically secondary binaries. Programs that do not require 
this type of code will have no secondary binaries. A user 
specified number of blocks is reserved for use by the program 
in the scratch area, generally for swapping under control of 
the program. The scratch area is optional and should only be 
allocated for programs requiring such a facility. 

Because the specific program can better define its requirements 
on the system, the only information AIPOS passes is the length 
of the file loaded and its starting block and unit number (on 
page 37; refer to the Monitor Internal Description). The pro¬ 
gram must determine from this the location of the secondary 
binaries and the scratch area. 

3.0 Using INIT 


The initialization program, INIT, creates LINCtapes and disks that 
can be used by the LDP system by placing the necessary index informa¬ 
tion and the AIPOS system (Monitor and Job Control) on the tape. 

To prepare an LDP tape/disk: 

1. Start the LDP system by the appropriate procedure 

in Appendix A of AIPOS User's Manual, DEC-12-SQ1A-D. 

2. When the initial Job Control display appears, type 
INIT and press the RETURN key. 

3. The first display of the INIT program appears: 

LDP UNIT TO INITIALIZE: 

LT0-7 LINCTAPE 
DKJ2J-3 DISK 

REPLY: 
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4. Type the mnemonic unit code for the device contain¬ 
ing the volume to be initialized for the LDP system. 
This volume must be a marked LINCtape or formatted 
disk. Then press the RETURN key. RETURN may be 
pressed alone as the reply to this display to return 
to Job Control. 

5. When an acceptable response is typed, the next dis¬ 
play appears: 


ENTER UP TO TEN CHARACTERS 
FOR VOLUME IDENTIFICATION 

REPLY: 


6. Up to ten printing DIAL characters may be typed in for 
volume identification purposes. The information entered 
this time appears as the first entry in an index display 
(DX). It may be helpful to use the date created as the 
volume identifier. 

7. After the volume identifier is entered and accepted, 
the next display is: 

HOW MANY INDEX BLOCKS SHOULD BE 
ALLOCATED? (1 TO 10 OCTAL) 

DEFAULT IS 4 

REPLY: 

The number of index blocks to be allocated to this 
volume is specified now. This value should be large 
enough to accommodate all future files because addition¬ 
al index blocks can only be allotted by reinitializing 
the volume, thereby losing all files currently on the 
volume. Use the following parameters as a guide in 
determining the number of blocks to allocate. 


32^q index entries/index block 

1st index block requires 3 entries for 
system use. 

Each file, alias, and deletion requires an 
index entry. It is suggested that a tape 
have at least four index blocks and a disk 
have ten blocks. 
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8. Type the number of blocks to be used for the index and 
press the RETURN key. 

9. If it is a LINCtape that is being initialized, the 
next display is: 

HOW MANY BLOCKS ARE MARKED ON 
THIS TAPE? (1000 TO 1600 OCTAL) 

DEFAULT IS 1600 

REPLY: 


If the tape was marked (via MARK12) for 1000 blocks, 
type 1000 ; if it was marked for 1600 blocks, type 1600 . 
Then press the RETURN key. If the volume being initial¬ 
ized is an RK8 disk, a length of 6260 ^ blocks is assumed. 


10. The next display is: 


WHERE ARE THE SYSTEM BINARIES? 

LT0-7 LDP TAPE 

DKj2f — 3 LDP DISK 

DIAL DIAL-MS FILES 

NO OMIT SYSTEM 

REPLY: 

If a system from another LDP volume is to be copied 
on to this volume, type the mnemonic unit designation 
for the device containing that volume. If carriage 
return alone is typed, the system will be copied from 
the current system residence device. If a new 
system is to be created from DIAL-MS binary files, 
type DIAL, which will cause the following display 
to appear: 

ENTER NAME, COMMA, AND DIAL UNIT 

OF LDP MONITOR BINARY. 

REPLY; 
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Type the DIAL name and unit of the device where the 
LDP Monitor resides. For the Monitor on LINCtape 
DEC-12-SQAA-U0, the DIAL name is M01 (for version 1) 
The unit number is as in DIAL-MS: 0-7 for tape and 
10-15, 20-25, 30-35 and 40-45 for RK8 disk. If no 
system is desired on the volume being initialized 
Ce.g., it is to be used for data only), type NO. 

All replies are followed by RETURN. 

11. After the Monitor is copied from the specified unit 
onto this volume, the following display appears: 

ENTER NAME, COMMA, AND DIAL UNIT 

OF LDP JOB CONTROL BINARY. 

REPLY; 

Type the DIAL name and unit number of the device 
where Job Control resides. For the Job Control bi¬ 
nary on LINCtape DEC-12-SQAA-U0, the DIAL name is 
JOBCTL. After it is copied, the message in step 3 
reappears. Another volume may then be initialized 
or Job Control can be reentered. 


Note that it is very poor practice to initialize the system unit be¬ 
cause the system may be copied to different tape blocks than it had 
before initialization. 


4.0 Using BUILD 


The BUILD program modifies DIAL binary files so they can be 
used by the LDP system. It is implemented as follows: 

1. After starting the LDP system, display the 
index of the volume on which binary files are 
to be built. Delete or rename any binary files 
present on the volume whose name is the same as 

a binary file that is to be built on that volume. 
(All binary file names have the extension .BIN.) 

T< ?hen the index is correct, return to the initial 
Job Control display. 

2. Respond to the display by typing 

BUILD unit:binfile 

where BUILD is followed by a space, unit is the 
mnemonic device code to contain the binary, followed 
by a colon, and binfile is the name of the binary 
file to be built. Terminate the command by pressing 
the RETURN key. 
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3. The initial BUILD display appears: 

BUILDING binfile.BIN 

ENTER NAME AND DIAL UNIT 

OF PRIMARY BINARY FILE 

REPLY: 

where binfile is the name of the binary file specified in 
the command in step 2. 

4. Type the name, a comma, and the unit (0-7 for tape, 10-17 
for disk) where the DIAL binary file to be built on the 
LDP volume is located, followed by a carriage return. The 
primary binary file is then built on the appropriate volume. 

5. If the primary binary does not have load and go arguments, 
the following message is displayed: 

ENTER STARTING MODE (P OR L) 

AND FIELD (0 TO 7), COMMA 

AND STARTING ADDRESS. 

REPLY: 

Specify the starting mode as P for PDP-8 mode or L for 
LINC mode, followed by an octal digit (0-7) for the 
field. If the starting mode is not included before 
the octal digit, PDP-8 mode is assumed; if the field 
is omitted, field 0 is assumed. Then type a comma 
and the 1 to 4 digit starting address, followed by 
a carriage return. (For example, a reply of 1,20 
means the program will be started at location 20 of 
field 1 in PDP-8 mode.) 

6. The next display is: 

ENTER NAME AND DIAL UNIT 

OF SECONDARY BINARY FILE 

STRIKE RETURN IF NO MORE. 

REPLY: 

7. Type the DIAL name, a comma, and the unit where the 
secondary (overlay) binary is located followed by a 
carriage return. The display in step 6 reappears. 

Additional secondary binaries may be entered. When 
all secondary binaries have been loaded, type RETURN 
as the reply to the display. 

8. The next display is: 

HOW MANY BLOCKS OF SCRATCH SPACE? 

DEFAULT IS NONE. 

REPLY: 
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9. Type the number of blocks of scratch space to be 
allocated in the binary file and press return. If 
none are to be allocated, just press the RETURN key. 

10. The following display will appear: 

HOW MANY WORKING AREAS 

DOES THIS PROGRAM NEED? (0-7) 

DEFAULT IS NONE 

REPLY: 

If the program requires a certain number of output 
files for correct operation (DORA, for example, re¬ 
quires 2), type this number, followed by carriage 
return. If the program needs no working areas, 
simply press RETURN. 


Whenever BUILD/INIT is waiting for completion of a mass storage 
read operation, the following message is displayed: 

READING FROM dev 


where dev is the mnemonic unit code for the device being read. 
Similarly, while waiting for output completion, the following 
message is displayed: 


WRITING ON dev 

These messages are intended as an aid to the user when a device 
is not ready or is write locked. 

When a new volume is initialized, it is often inconvenient to 
obtain the binary files to be stored on it from DIAL-MS files. 
In this case, the file handling function MOVE can be used to 
copy binary files from one LDP volume to another. 

For example, if the programs BUILD, DORA and MOVE are on disk 
JZf and are desired on a newly initialized tape on unit 1, the 
correct sequence of commands is: 

MOVE LT1:BUILD.BIN=DK0:BUILD.BIN J 
MOVE LT1 :DORA.BIN=DKJ0 :DORA.BIN J 
MOVE LTl:MOVE.BIN=DK0:BUILD.BIN J 

Note that because INIT.BIN is an alias of BUILD.BIN, it is 
not necessary to MOVE it separately; the ALIAS facility of 
DISPLAY INDEX may be used. Similarly, all the file handling 
functions may be created as ALIASes of MOVE. 


J 
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5.0 The Routines 


The program starts at the tag "BEGIN", location 4000 in field 0. 
Here the name by which it was called (obtained from page 37) is 
checked. If the first two characters of the name are "IN", the 
call is assumed to be an initialization request, and control 
passes to INT000. Otherwise, control flows to BUILD. 

The loop from BUILD to NEXT examines each FDB in page 3 7 for 
output requests on mass storage devices. Each time it finds 
one with a non-blank name, it moves the name to the initial 
BUILD display, QPRIN, and calls the subroutine MAKBIN to build 
a binary file. 

MAKBIN calls the subroutines ASK (to display a message and wait 
for a response on the Teletyp^ - ) , GDIAL (to interpret an answer 
of the form "filename,unit", look up the file in a DIAL index, 

and leave the unit in ILIST, the starting block in ILIST+4, 
and the complement of the length in REMAIN), and CPYFIL to move 
the file from DIAL to LDP. If HDRSW= -1, CPYFIL interprets 
the first block of the input file as a header in the DIAL Loader 
format, and calls the routine CVH to convert the header to a 
form suitable for the LDP loader. If the header does not con¬ 
tain starting information, CVH asks the operator for that in¬ 
formation in the form: 

mf,address where m is the starting mode: 

P implies PDP-8 mode 
L implies LINC mode 
(default is P); 
f is the starting field; any 
octal digit, 0 assumed if 
not specified; 

address is one to four octal 
digits, specifying the start¬ 
ing address within field f. 


All mass storage I/O, in CPYFIL and elsewhere, is performed by 
the routines GET and PUT, which call the LDP Monitor to perform 
a read or write, then display a message until the operation is 
completed. This makes it easier for the operator to determine 
the cause of the problem when the system hangs due to a write 
lock or incorrectly selected unit. 

r~ 

Teletype is a registered trademark of Teletvoe CorDoration. 
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Volume initialization is performed starting at INT000, where 
ASK is called to determine the unit containing the volume to 
be initialized. A null response (carriage return alone) causes 
a jump to EXIT to recall Job Control. Otherwise, GLDPU is 
called to interpret an LDP mnemonic unit code. The volume iden¬ 
tification is obtained and stored at XBUF, along with the number 
of index blocks desired. If the unit is tape, ASK is called to 
obtain the number of blocks marked on the tape (number of blocks 
is always 6260 on disk). This number is also saved following 
XBUF. At INT150, the current system unit is determined by find¬ 
ing the I/O control block used to reload Job Control (this is 
the default for the next question), and ASK is called to deter¬ 
mine the source from which to obtain the system (that is, the 
Monitor and Job Control). The allowable responses are: 

null (carriage return alone) - use the current system unit 

NO - do not put a system on the volume 

DIAL - get the system from DIAL-MS binary files 

LT0-7 or DK0-3 - use the system on the specified device 


If the response is NO, control passes to INT300, which moves 
appropriate code into XBUF to create a "NO" index. A "NO" 
index is one which causes a display of NO when an attempt is 
made to load the system from that volume. 

If the response is "DIAL", the code at INT200 uses ASK and 
GDIAL to obtain the DIAL files containing the Monitor and Job 
Control, and calls CPYFIL to move them to the new LDP volume. 

If the response is neither NO nor DIAL, GLDPU is called to de¬ 
code the unit requested, its index is read, and (if it contains 
the system), the Monitor and Job Control are copied, via CPYFIL, 
to the new LDP volume. Control passes to INT215, where the ap¬ 
propriate startup code is moved into XBUF, a working area entry 
is created in the first file entry of the index, and XBUF is 
copied to field 1 for writing. All the remaining index entries 
are cleared, and PUT is called to write the index. Control then 
returns to INT000 to begin initialization of another volume. 



6. 0 Core Map 


Field 0 

0 - 43 Reserved for Monitor 

44- 137 BUILD/INIT page 0 

140-2577 Monitor 

2600-3777 Unused 

4000-4177 Main BUILD code 

4200-53xx Common subroutines 

53xx-61xx Main INIT code 

61xx-7377 Index skeletons and displays 

7400-7577 Unused 

7600-7777 Page 37 information in BUILD, XBUF in INIT 

Field 1 

0-7777 CPYFIL buffer 
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7.0 Flowcharts 
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